home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d3 / me30.arc / LIST.DOC < prev    next >
Text File  |  1990-10-13  |  32KB  |  886 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                         LIST  Version 6.0j
  7.                 (c) Copyright  Vernon D. Buerg 1986
  8.  
  9.                          October 13, 1986
  10.  
  11.  
  12.  
  13.                         Table of Contents
  14.                         -----------------
  15.  
  16.                 Description of use ...............  1
  17.  
  18.                 Keys and commands ................  3
  19.  
  20.                 Positioning to lines .............  5
  21.  
  22.                 Display format ...................  6
  23.                  Status line .....................  6
  24.                  Command line ....................  7
  25.  
  26.                 Screen colors ....................  8
  27.                  Cloning procedure ...............  9
  28.                  DEBUG Information ............... 10
  29.  
  30.                 Searching for text................ 11
  31.  
  32.                 Filtering ........................ 12
  33.  
  34.                 Update history ................... 13
  35.  
  36.                 Restrictions ..................... 14
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                                         LIST     Page 1
  60.  
  61.  Command  LIST
  62.  -------------
  63.  
  64.  
  65.  Purpose:
  66.            You use LIST to display  files on your monitor, line  by line
  67.         with the aid of scrolling, positioning and filtering commands.
  68.  
  69.  
  70.  Format:
  71.                  LIST  [d:][path]filename[.ext]
  72.  
  73.  
  74.  Remarks:
  75.            You may rename the program file to any convenient name,  such
  76.         as  L.COM,  READ.COM,  or LIST.COM.
  77.  
  78.            Using  LIST  is  fairly  easy.   You  type  the  command LIST
  79.         followed by  the name  of the  file that  you want  to see.  For
  80.         example: LIST CONFIG.SYS would display the file CONFIG.SYS.
  81.  
  82.            Once the file  is displayed on  your screen, you  may use the
  83.         cursor positioning keys to  move around and see  different parts
  84.         of the file.  For example,  when LIST first starts, you  see the
  85.         first 23 lines of the file.  To see the next 23 lines, or  page,
  86.         press the PgDn key.   The PgUp key moves  you back one page  and
  87.         shows you the  previous 23 lines.   The up-arrow and  down-arrow
  88.         keys move it  one line at a time.  When you are finished,  press
  89.         the ESCape key and you are returned to the DOS prompt.
  90.  
  91.            The "filename" is optional.  If omitted, you are prompted  to
  92.         to enter  a filename.   You may  include drive,  path, and  wild
  93.         cards in the file name.   The first file which matches  the name
  94.         is displayed.  After that file is displayed, the next file which
  95.         matches the "filename" may be displayed, too.
  96.  
  97.            You may also use LIST  to display piped or redirected  files.
  98.         If you are unfamiliar with these, you may skip to the next page.
  99.  
  100.         To display a redirected file, use a < (less than symbol)  before
  101.         the name  of the  file  and  add the  /S parameter  to the  LIST
  102.         command.  For example:
  103.  
  104.                 dir a: >xyz
  105.                 list <xyz /s
  106.  
  107.         To display a piped file,  omit the filename,  but supply the /S.
  108.  
  109.                 dir a: | list /s
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                                         LIST     Page 2
  119.  
  120.  
  121.  
  122.            Because  files  contain  different  kinds  of data, there are
  123.         several commands  to tell  LIST how  to display  the data.   The
  124.         process that LIST uses to make the file data readable is  called
  125.         filtering.  The filters in LIST can:
  126.  
  127.             - replace non-text and control characters with blanks
  128.             - expand TAB characters
  129.             - display line drawing characters
  130.             - change 8-bit (W*) data to readable 7-bit text
  131.             - display the hexidecimal values for each character
  132.  
  133.  
  134.            LIST was  designed to  display ASCII  files.  That  is, files
  135.         which  contain  text, and  not  binary  or  control codes.  Text
  136.         characters usually  range from  a value  of 32  to 127.  To view
  137.         binary  files  (COM,  EXE,  etc),  the  alt-H (hex dump display)
  138.         command is available.
  139.  
  140.  
  141.            Characters  below  32  (a  blank)  are  replaced with a funny
  142.         character to indicate that a non-displayable character has  been
  143.         encountered.  This  character is  an upside-down  question mark.
  144.         Characters above 127 may be valid graphic characters, and may be
  145.         displayed  if  the  '8'  command  is  in effect.  To insure that
  146.         characters above ASCII value 127 are not displayed, use the  '7'
  147.         command.
  148.  
  149.  
  150.            The top  line of  the display  gives the  file name,  current
  151.         right  scroll  offset,  and  the  file's creation date and time.
  152.         Optionally, a ruler  may be displayed  on the top  line by using
  153.         the alt-R keys.
  154.  
  155.  
  156.            The  file  is  displayed  with  one  logical  record  on each
  157.         80-column display line.   A logical record  ends in a  linefeed.
  158.         The maximum logical record may  be 256 characters long.  If  the
  159.         record exceeds 80  characters, you may  view the portion  beyond
  160.         the 80 columns  by using the  scroll right command,  or by using
  161.         the  Wrap  feature.   The  Wrap  command  toggles  ON or OFF the
  162.         wrapping  of  lines  longer  than  80 characters.  With Wrap on,
  163.         lines are displayed in their entirety, 80 characters per display
  164.         line.  The scroll -left  and -right functions are  disabled when
  165.         Wrap is ON.
  166.  
  167.            The file may  be PRINTed as  it it displayed.   The P command
  168.         toggles  the  printer  on  or  off.   When  first entered, the P
  169.         command causes the current screen  to be printed.  As new  lines
  170.         are displayed, they too are printed.  Printing may be stopped by
  171.         entering another P command.  The PrtSc key may also be used, but
  172.         the title and prompt lines will be printed with the lines of the
  173.         file.  Empty lines  cause a line  to be skipped  on the printer.
  174.         The letter P  is displayed in  column 80 of  the top line  while
  175.         printing.
  176.  
  177.                                                         LIST     Page 3
  178.  
  179.  Key functions and Commands
  180.  --------------------------
  181.  
  182.         On the COMMAND line, enter a letter or control key:
  183.  
  184.         Control key      Function
  185.         -----------     -------------------------------
  186.         left arrow      scroll left 20 columns
  187.         right arrow     scroll right 20 columns
  188.         up arrow        up one (previous) line
  189.         down arrow      down one (next) line
  190.  
  191.         Enter           continue to next page
  192.         END             position to end of file (bottom)
  193.         ESCape          Display next matching file
  194.         HOME            restart from first line (top)
  195.         PgUp            scroll up one page, 23 lines
  196.         PgDn            scroll down one page, 23 lines
  197.  
  198.  
  199.         Letter(s)     Default   Function
  200.         ---------     -------   ------------------------
  201.         A                       find next occurance of 'text' (Again)
  202.         B                       skip to end of file (Bottom)
  203.         C               off     toggles Closing of files, also alt-S
  204.         D                       scroll Down one page
  205.         F                       Find 'text' regardless of case
  206.         G                       Get new filename/filespec (also alt-F)
  207.         H or ?                  list commands (Help)
  208.         K               off     toggle Keyboard flush; if on, commands
  209.                                 may be queued up by holding a key down
  210.         L                       scroll Left 20 columns
  211.         M               on      toggle test for display retrace, if on
  212.                                 the display is faster but may flicker;
  213.                                 not applicable to monochrome monitors
  214.         N                       down one (Next) line
  215.         P               off     toggle Printer on or off
  216.         Q                       Quit, display next matching file
  217.         R                       scroll Right 20 columns
  218.         S                       Scan for exact text match, case dependent
  219.         T                       restart from first line (Top)
  220.         U                       scroll Up one page (23 lines)
  221.         W               off     toggle Wrap of lines over 80 chars
  222.         X                       terminate, clear screen and eXit to DOS
  223.  
  224.         7               off     turn off high bit (non-graphics only)
  225.         8               on      leave high bit on (graphics)
  226.         *               off     toggles special * document filtering
  227.  
  228.         +                       position a given number of lines forwards
  229.         -                       position a given number of lines backwards
  230.  
  231.         \text                   Find 'text' regardless of case
  232.         /text                   Scan for exact text match
  233.  
  234.  
  235.  
  236.                                                         LIST     Page 4
  237.  
  238.  Key functions and Commands (cont.)
  239.  --------------------------
  240.  
  241.     Control key      Function
  242.     -----------     -------------------------------------------
  243.      F1              Help - display summary of commands
  244.      F3              Find next occurrance of text after Scan or Find
  245. |    F9              Find previous occurrance of text after Scan or Find
  246.      F10             Exit to DOS with clear screen and cursor last line
  247.  
  248.      F2              change background color for Find/Scan text
  249.      F4              change foreground color for Find/Scan text
  250.  
  251.      F5              change background color for main body of display
  252.      F6              change foreground color for main body of display
  253.  
  254.      F7              change background color for top and bottom lines
  255.      F8              change foreground color for top and bottom lines
  256.  
  257.      ctl-HOME        positions to a specific line number
  258.      ctl-PgUp        restart from first line (TOP)
  259.      ctl-PgDn        skip to end of file (BOTTOM)
  260.      ctl-left-arrow  reset scroll to column 1
  261.  
  262.      alt-A           toggle Apxcore(on), DesqView/DoubleDos(off-default) use
  263.  
  264.      alt-C           clone LIST.COM, change colors or options permanently,
  265.                      in a new copy of the LIST.COM program file
  266.  
  267.      alt-E           toggle 25/43 line display (does test for EGA)
  268.  
  269.      alt-F           prompt for new Filespec or filename to display
  270.                      entering a leading asterisk (*) may be obscured
  271.                      by some console enhancers or utilities, so enter
  272.                      two asterisks, e.g. **.doc
  273.  
  274.      alt-H           toggles hex dump formatted display
  275.  
  276. |    alt-L           toggle preloading of files, default is OFF
  277.                      When the file is pre-loaded, the ending line
  278.                      line number becomes known.
  279.  
  280.      alt-R           toggles display of a ruler on the top line
  281.  
  282.      alt-S           toggles file Sharing option, when off
  283.                      files remain open until program termination
  284.  
  285.      alt-T           toggles expansion of TAB control characters, the
  286.                      tab columns are a multiple of 8, i.e. 1,9,17, etc.
  287.                      The default is to expand TABs.
  288.  
  289.      alt-W           toggles split screen; when ON, the top half of
  290.                      the screen is frozen. Further scrolling occurs
  291.                      only in the bottom half of the screen (window)
  292.                      until the alt-W keys are used again.
  293.  
  294. |    alt-X           exits to DOS and displays the original screen
  295.                                                         LIST     Page 5
  296.  
  297.  
  298.  Positioning to Lines
  299.  --------------------
  300.  
  301.            Each displayable line of the file is assigned a line  number.
  302.         The first line is assigned line number 1.  The highest allowable
  303.         line  number  is  65535.   In  order  to determine the last line
  304.         number, the  entire file  must be  read.  For  this reason,  the
  305.         first time that the END (bottom) command is issued, it will take
  306.         longer  to  process.   This  is  not  necessary  if  the file is
  307. |       preloaded using the alt-L installation option.
  308.  
  309.            If the  Wrap option  is in  effect, there  is one line number
  310.         required for each 80 bytes of the file's records.
  311.  
  312.            If the hex dump option is in effect, there is one line number
  313.         required for each 16 bytes of the file.
  314.  
  315.            You  may  position  to  a  specific  line number by using the
  316.         c-Home, Ctrl key  and Home key,  or the #  key.  When c-Home  is
  317.         entered, you are prompted for the line number.  Enter the 1 to 5
  318.         digit line number.   The display will  now begin with  that line
  319.         number at the top of the screen.
  320.  
  321.            To position forward or backward, you may use the + (plus), or
  322.         - (minus) keys.  You are  prompted to enter the number  of lines
  323.         to be skipped.  The display resumes at the line number shown  on
  324.         the top (status)  line, plus or  minus the number  of lines that
  325.         you specified.
  326.  
  327. |          When you change a  filter  option,  such as Wrap,   the  line
  328. |       numbering changes.  An attempt is made to  retain  the same file
  329. |       position.
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                                                         LIST     Page 6
  355.  
  356.  Display format
  357.  --------------
  358.  
  359.            The monitor display is defined in terms of lines and columns.
  360.         A typical monitor can display 25 lines of 80 columns each.  LIST
  361.         attempts to use the number of lines and  columns for the monitor
  362.         mode in use.  For example, if the monitor is in 40 column  mode,
  363.         LIST displays only 40 characters per line.
  364.  
  365.            The top line of the  display is called  the Status line.  The
  366.         bottom line is called the Command line.  The remaining lines are
  367.         called the  primary  display  window,  and are usually lines two
  368.         through 24.
  369.  
  370.  
  371.  Status line format
  372.  ------------------
  373.  
  374.     The Status line has the following format:
  375.  
  376.      LIST   lllll nnnnnnn +sss mm/dd/yy hh:mm  - filename
  377.  
  378.     where,
  379.  
  380.         'LIST'     is the name of this program
  381.  
  382.         'lllllll'  is the line number of the first line in the
  383.                    display window (usually on line 2)
  384.  
  385.         'nnnnnnn'  is the line number of the last record, if known
  386.  
  387.         '+sss'     if displayed, this is the Scroll amount, in
  388.                    multiples of 20, corresponding to the number
  389.                    of columns that the display has been shifted
  390.                    to the right to view records longer than 80
  391.  
  392.         'mm/dd/yy' is the file's creation date
  393.         'hh:mm'    is the file's creation time
  394.  
  395.  
  396. |       Note:      The date and time  shown on the top line is  NOT  the
  397. |              current date.  It is the date and time  that the file was
  398. |              created.
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                                         LIST     Page 7
  414.  
  415.  Command line format
  416.  -------------------
  417.  
  418.     The Command line has the following format:
  419.  
  420.       command message _________ Options: dbkmpswtalj Keys: X=exit ?=Help
  421.  
  422.     where,
  423.  
  424.   'command' indicates the current process:
  425.  
  426.           'Command'   you are being asked to enter a command
  427.                        enter the letter, or press the keys for
  428.                        the action to perform
  429.  
  430.           'Reading '   the file data is being read
  431.           'Filter  '   the file data is being formatted for display
  432.           'Scanning'   the Scan/Find text is being searched for
  433.  
  434.           'Scan   '   you are being asked to enter text to locate
  435.           'Find   '   in the file, up to 31 characters may be entered
  436.  
  437.           '# lines?'   you are being asked to enter a 1 to 5 digit
  438.                        number that is the amount of lines to skip
  439.  
  440.           'Line #? '   you are being asked to enter a 1 to 5 digit
  441.                        line number to which the display is to be
  442.                        positioned
  443.  
  444.  
  445.     'message' may be one of:
  446.  
  447.           '*** Text not found ***'
  448.            the Scan/Text was not found in the file
  449.  
  450.           '   *** Top of file ***'
  451.            the first line of the file is being displayed
  452.  
  453.           '   *** End-of-file ***'
  454.            the last line of the file is being displayed
  455.  
  456.         St: indicate status of toggles, lower case means off:
  457.  
  458.         'D'       indicates that the hex Dump display option is in use
  459.         'b'       indicates whether the 7-bit, 8-bit, or *-option is
  460.                   in use
  461.         'K'       indicates that the Keyboard flush option is in use
  462.         'M'       indicates that tests for monitor retrace are not made
  463.         'P'       indicates that Print is in use
  464. |       'S'       indicates that file closing (for sharing) is in use
  465.         'W'       indicates that the Wrap mode is in effect
  466.         'T'       indicates that TAB characters are expanded
  467. |       'A'       indicates APXCORE interface, 'a' for TV/DV/DD
  468. |       'L'       indicates that the pre-loading option is on
  469. |       'J'       indicates that line feeds (ctrl-J) are added to lone
  470. |                 carriage return control characters
  471.  
  472.                                                         LIST     Page 8
  473.  
  474.  Screen colors
  475.  -------------
  476.  
  477.         The screen's lines may be in any of three different colors:
  478.  
  479.                 - the 'special' color for the top status line and the
  480.                   bottom command line
  481.                 - the 'normal' color for the file's text windows
  482.                 - the 'bright' color for lines with Find/Scan text,
  483. |                 and for the upside-down question mark in 7-bit mode
  484.  
  485.            There is a pair of function keys assigned to each color.  You
  486.         may  use  these  function  keys  to  change  the  background and
  487.         foreground  colors  temporarily.   To  make  the  color  changes
  488.         permanent, you may use the cloning command (alt-C), or use DEBUG
  489.         to modify the program file.
  490.  
  491.            The colors used  for displaying the  titles and main  body of
  492.         text  may  be  changed  temporarily  or  permanently.  To make a
  493.         permanent  change,  the  cloning  command  alt-C  is  used.   It
  494.         requires that the LIST.COM program file be on the current  drive
  495.         and in the current directory.
  496.  
  497.            The border is not  changed.  The foreground color  applies to
  498.         the characters displayed.
  499.  
  500.  
  501.         The color attributes may be changed by using these function keys:
  502.  
  503.           For the main body of text:
  504.  
  505.             F5 - background color
  506.             F6 - foreground color
  507.  
  508.           For the top and bottom lines:
  509.  
  510.             F7 - background color
  511.             F8 - foreground color
  512.  
  513.           For the line with Find/Scan text:
  514.  
  515.             F2 - background color
  516.             F4 - foreground
  517.  
  518.            Once you  have decided  upon the  colors,  use the alt-C  key
  519.         combination to change the LIST.COM program file.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                                                         LIST     Page 9
  532.  
  533.  Cloning procedure
  534.  -----------------
  535.  
  536.            The screen colors, the display retrace testing (M), the  file
  537.         closing (C) and ruler (alt-R) options may be permanently set  in
  538.         the program by using the alt-C cloning function.
  539.  
  540.            For  cloning  to  take  effect,  the  program  must be called
  541.         LIST.COM and it must be on the current drive and in the  current
  542.         directory.  There are two versions of the LIST COM file.  One is
  543.         the normal  program.  The  other, which  contains an  'S' as the
  544.         last letter of  the file name,  is a slightly  smaller file that
  545.         excludes  the  Help  screen.   You  may  use either COM file for
  546.         cloning.
  547.  
  548.            The clonable options (command toggles) are:
  549.  
  550.              M      =  Mono monitor, affects retrace testing,
  551.              C      =  file(s) are shared,
  552.              W      =  Wrap long lines
  553.              8/7/*  =  display all 256 values, or 7-bit, or special cases
  554.              K      =  flush Keyboard each time a command is read
  555.  
  556.              alt-A  =  set on if using Apxcore, off if using Double Dos
  557. |                      or TopView, or DesqView
  558.  
  559.              alt-H  =  hex dump display, like the DEBUG format
  560.  
  561. |            alt-J  =  toggle generation of line feeds for lone CRs
  562.  
  563. |            alt-L =   set on to force preloading (reading) of entire
  564.                        file before any lines are displayed, default is OFF.
  565.  
  566.              alt-R  =  toggle columnar ruler on top line
  567.  
  568.              alt-T  =  toggle expansion of TAB characters
  569.  
  570.  
  571.         Note: Be sure you have no other copies of LIST.COM which
  572.         are accessible (because of a filepath type of utility).
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                                         LIST     Page 10
  591.  
  592.  
  593.  DEBUG Information
  594.  -----------------
  595.  
  596.            An alternative to cloning is  to use DEBUG to make  permanent
  597.         changes.  Here is a list of key items and their addresses:
  598.  
  599.            0122 - special lines 1 and 25 colors, default is 01 (blue)
  600.                   Refer to a technical reference guide for the
  601.                   attribute values for the colors that you want.
  602.            0124 - normal lines 2 thru 24 colors, default is 02 (green)
  603.            0126 - bright color for Find/Scan, default is 0C (bright red)
  604.            0128 - options; bits 0 through 6
  605.                    MRSD WHK*  M = mono, retrace testing if off, x'01'
  606.                               R = ruler, x'02'
  607.                               S = shared, x'04'
  608.                               D = hex display, x'08'
  609.                               W = wrap mode, x'10'
  610.                               H = hi-bit on, x'20'
  611.                               K = kybd flush, x'40'
  612.                               * = special document filtering, x'80'
  613.  
  614.            0129 - clonable options, not indicated:
  615. |                  .PATJ .... P = Preload file if on, x'02', default is off
  616.                               A = Apxcore if on, TV/DD/DV if off, x'04,
  617.                                   default is for Topview/Double DOS use
  618.                               T = expand TABs if on (default), x'08
  619. |                             J = add LF to lone CR (default), x'10'
  620.  
  621.                   By specifying  the bit  value, the  option is enabled.
  622.                   For example, to enable  Shared and Retrace, specify  a
  623.                   hex value of the sum, or 01+04 = 05.
  624.  
  625.  
  626.         When the Find/Scan command is used, the next line which contains
  627.         that text is highlighted using the 'bright' color, and is placed
  628.         in row 11 of the screen.  You can change the row by altering the
  629.         byte at location 12A which is normally '0A'.
  630.  
  631.            The letters and command keys may also be changed.  There  are
  632.         two tables involved: WHAT and WHERE.  The WHAT table contains  a
  633.         list of  one-byte keyboard  codes.  The  WHERE table  contains a
  634.         list  of  two-byte  matching  addresses.   If you really want to
  635.         change the codes, here are the DEBUG addresses:
  636.  
  637.            0359 - *WHAT* eye catcher
  638.            035F - list of one byte command letters and codes
  639.  
  640.            039F - *WHERE* eye catcher
  641.            03A6 - list of two byte addresses of processing routines
  642.  
  643.         NOTE: These DEBUG addresses are version dependent.
  644.         ==================================================
  645.  
  646.  
  647.  
  648.  
  649.                                                         LIST     Page 11
  650.  
  651.  Scanning for text
  652.  -----------------
  653.  
  654.  
  655.            You may  use Find  (\) to  search for  text regardless of the
  656.         case, or you may use Scan (/) to find an exact match.
  657.  
  658.            To scan for a character string, type a slash (/) followed  by
  659.         one or more (up to 31)  characters.  The scan text, but not  the
  660.         slash,  is  displayed  on  the  command  line.  The scan is case
  661.         sensitive.  That is, lower case scan text will only match  lower
  662.         lower case file text.
  663.  
  664.            While  the  program  is  searching  for  the text, the bottom
  665.         display line  is changed  to say  "Scanning".  Pressing  any key
  666.         while the search  is in progress  will terminate the  search and
  667.         display the message 'Text not found' on the bottom line.
  668.  
  669.            If the text is found, the line containing it is displayed  as
  670.         a high-intensity line (bright color).
  671.  
  672.            If the text is NOT found, the bottom line (25) is changed  to
  673.         say '*** text not found ***', and the display remains unchanged.
  674.  
  675.            To find the next occurrance of the same text, use the  A)gain
  676.         command, or press the F3 key.
  677.  
  678.            If the  PCED keyboard  enhancement program  is installed, the
  679.         up/down cursor keys  may be used  to recall and  edit previously
  680.         entered Scan/Find text.
  681.  
  682.            In a shared file environment, if the file changes while being
  683.         listed,  the  file  position  may  become invalid.  Use the HOME
  684.         command  to  insure  proper  file  synchronization, or use the C
  685.         (shared) option.
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.                                                         LIST     Page 12
  709.  
  710.  Filtering
  711.  ---------
  712.  
  713.            Filtering is the term used to describe the process that  LIST
  714.         uses to  format file  data for  displaying on  a monitor.  After
  715.         data  is  read  from  a  file,  it  is  filtered.  The method of
  716.         filtering depends upon the options in effect.
  717.  
  718.            For a typical  ASCII text file,  the filter removes  carriage
  719.         return and line feed characters, and expands TAB characters.
  720.  
  721.            The  7,  8,  and  *  (asterisk)  commands  determine  whether
  722.         characters above ASCII-127 are displayed.  If the hi-bit  option
  723.         is off (7  command), the filter  strips the high  order bit from
  724.         each character.   If the  hi-bit option  is on  (8 command), all
  725.         characters, including  graphic characters  above ASCII-127,  are
  726.         displayed.
  727.  
  728.            The * (asterisk) command displays only ASCII characters below
  729.         128 (x'80'), but treats  the special characters x'8A'  and x'8D'
  730.         as line-feed and carriage-return control characters.  Any  other
  731.         characters above 127 are treated as spaces.
  732.  
  733.            The Wrap option causes the  filtering to insure that no  line
  734.         exceeds the width of the monitor, e.g. 80 characters.
  735.  
  736.            The hex dump option (alt-H) causes the filtering to  reformat
  737.         the file  data into  a DEBUG-like  display format.   The largest
  738.         file that can be "dumped" is 1 million bytes.
  739.  
  740.            An attempt is made to retain the file position when switching
  741.         from normal to hex-dump  display, but due to  filtering changing
  742.         record lengths,  the hex  display may  begin before  the current
  743.         record.
  744.  
  745.         NOTE:   The  EOF  control character is  ignored in this version.
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.                                                         LIST     Page 13
  768.  
  769.  Update history
  770.  --------------
  771.  
  772.  There is a new version  of LIST made available frequently.  If the new
  773.  features or corrections do not interest you, stay with the version you
  774.  have. The complete version history is now kept in a another file.
  775.  
  776.  Lines beginning with | denote changes to the latest version.
  777.  
  778.         Version 6.0a thru 6.0e, August 30, 1986
  779.             - corrections to last line number
  780.             - correct disappearing EGA/EGD cursor (?)
  781.             - correct test for TopView according to Hersey
  782.             - correct display after change to 43-line mode
  783.             - correct detection of EGA number of lines
  784.  
  785.         Version 6.0f, August 31, 1986
  786.             - correct problem with 8 command, always stripping hibit
  787.  
  788.         Version 6.0g, Sept 4, 1986
  789.             - cosmetic corrections to Help screen
  790.             - increase data buffer to reduce "jumpy" display
  791.             - remove some tweaking of the cursor shape
  792.             - default to retrace testing off (M on)
  793.             - improve readability of binary files in ASCII display mode
  794.               by changing handling of EOF character; this also solves
  795.               a problem with files whose last record does not contain
  796.               a cr/lf. Remember, LIST expects "records" to have CR and/or LF.
  797.  
  798.         Version 6.0h, Sept 17, 1986
  799.             - correct alt-F looping when invalid filespec entered
  800.             - correct Wrap failing if W ON was cloned
  801.             - more fussing with the EGA cursor, nothing can be done
  802.               about colors/pallete resetting when changing modes
  803.             - correct value of last line number when toggling Wrap
  804.             - notes: the default for preload (alt-P) is OFF, alt-P
  805.               is a toggle; the default of retrace testing in ON and
  806.               may result in snow on some color monitors.
  807.  
  808. |       Version 6.0i, Sept 28, 1986
  809. |           - Added alt-X to exit with original screen displayed
  810. |           - Added alt-A as A, and alt-L as L in "Options:" line display
  811. |           - Added F9 command to find previous occurance of text
  812. |           - Compensated for old Sigma EGA ROM (pre 1.06)
  813. |           - Changed alt-P to alt-L; preload option toggle
  814.  
  815. |       Version 6.0j, Oct 13, 1986
  816. |           - Added alt-J to toggle the generation of line feeds (LF)
  817. |             for lone carriage returns (CR). Makes easier viewing of
  818. |             files which use backspace, or over printing, to emphasize
  819. |             a line.
  820. |           - Corrected the handling of ESCape during Scan/Find
  821.  
  822.  
  823.  
  824.  
  825.  
  826.                                                         LIST     Page 14
  827.  
  828.  
  829.  Restrictions
  830.  ------------
  831.  
  832. |         o  The program requires 64K bytes of memory.  If more memory
  833.              is available,  it  is  used  to store more of the file in
  834.              memory.
  835.  
  836.           o  The line number is currently limited to 65535.
  837.  
  838.           o  The  file  size  is  limited  to 16 million bytes for ASCII
  839.              files, and to 1 million bytes for hex-dump files
  840.  
  841.           o  PC DOS Version 2.0 or later is required.
  842.  
  843.           o  ANSI.SYS is NOT required.
  844.  
  845.         APX Core, DesqView, TopView, and Double DOS, IBM,  Sigma are all
  846.         copyrighted,  trademarked,  and all that.
  847.  
  848.         Written by Vernon Buerg for the  IBM PC using DOS 2.0 or  later,
  849.         through DOS 3.1.
  850.  
  851.         LIST  is  supplied  for  personal,  private  use.   Feel free to
  852.         distribute LIST given these restrictions:
  853.  
  854.           o  the program  shall be supplied in its original,  unmodified
  855.              form, which includes this documentation;
  856.  
  857.           o  no fee is charged;
  858.  
  859.           o  "commmercial" use without a license is prohibited;
  860.  
  861.           o  the program may not be included -  or bundled - with  other
  862.              goods or services.  Exceptions may be granted upon  written
  863.              request only. This applies to clubs and distributors.
  864.  
  865.  
  866.         If you are  using LIST and  find it of  value, your gift  in any
  867.         amount  ($15  suggested)  will  be  greatly  appreciated.  Makes
  868.         checks payable in U.S. dollars to Vernon D. Buerg.  Thank you.
  869.  
  870.         For use by corporations  and other institutions, please  contact
  871.         me at AAI  Systems for a  site licensing agreement.  The source,
  872.         customizing,  and  special  licensing  are  also available  upon
  873.         request.  Purchase orders and invoicing are acceptable.
  874.  
  875.  
  876.                 Vernon D. Buerg
  877.                 456 Lakeshire Drive
  878.                 Daly City, CA  94015
  879.  
  880.                 Work:       (415) 991-0644   AAI Systems after 10am Pacific
  881.                 Data:       (415) 994-2944   VOR 24-hour bulletin board
  882.                 Fidonet:    125/4
  883.                 Compuserve: 70007,1212
  884.  
  885.  
  886.